home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / amiga / animutil / movie / movie.rdm < prev   
Text File  |  1991-07-24  |  4KB  |  108 lines
  1.                        -- MOVIE 1.3 --
  2.  
  3. Movie is a freeware utility which may be used to play back animations
  4. created by Sculpt Animate 3D.  Movie was written by Dr. Eric Graham,
  5. author of SCULPT 3-D and Sculpt Animate 3D.  Movie's sound capability
  6. was added by Ken Offer of Byte by Byte. 
  7.  
  8. The CLI syntax for MOVIE is "MOVIE animfile [audiofile]", where
  9. "animfile" is the name of the RAM animation and "audiofile" is an
  10. optional audio specification file, as explained below.
  11.  
  12. To run MOVIE from the Workbench, you need to attach an icon to the
  13. animation.  This may be done by copying the ".info" file from an
  14. existing animation, although any PROJECT type icon will do.
  15.  
  16. To play an animation, hold down a SHIFT key and click the animation's
  17. icon, then double-click the MOVIE icon.
  18.  
  19. If the animation icon's info structure (accessed through the
  20. Workbench's INFO menu command) has MOVIE specified as the default tool
  21. and MOVIE is on the same directory, then you may run the animation
  22. just by double-clicking its icon. 
  23.  
  24. You may add the animation author's name to the opening screen text by
  25. inserting it into the tooltypes gadget of the animation's info screen.
  26. This is done by adding a line such as "AUTHORNAME=Aurthur Name".  Case
  27. is important.  Omit the quotes.
  28.  
  29. Another item which may be added to the tooltypes is an audio
  30. specification file, an example might be "AUDIOSPECFILE=myanim.audio".
  31. The audio file tells Movie how and when to play back sampled sounds.
  32. To have audio, you must have some number of IFF 8SVX "one-shot" sound
  33. files (NOT instrument files) on the same directory as the animation,
  34. as well as an audio specification in the following format:
  35.  
  36.    +-----------------------------------------------------------
  37.    |IFFSoundFileName0
  38.    |IFFSoundFileName1
  39.    |IFFSoundFileName2
  40.    |
  41.    |    ...and so on, ending the filenames with an '*'.
  42.    |
  43.    |*
  44.    |NForegroundSoundSeq  (i.e.  # of foreground sound frame sequences)
  45.    |Frame#  Sound#  (L for left channel, R for Right) Volume
  46.    |Frame#  Sound#  L or R  Volume
  47.    |...
  48.    |NBackgroundSoundSeq  (i.e.  # of background sound frame sequences)
  49.    |Frame#  Sound#  (L for left channel, R for Right) Volume
  50.    |Frame#  Sound#  L or R  Volume
  51.    |...
  52.    |
  53.  
  54.    An Example is below:
  55.  
  56.    +-------------------------------------------------------
  57.    |gong
  58.    |whistle
  59.    |*
  60.    |2
  61.    |0  0  L  64
  62.    |15 0  R  32
  63.    |1
  64.    |0  1  L  20
  65.  
  66.    The above example will play one sound twice (2) in a cycling animation.
  67.  
  68. At frame 0, it will play sound 0 (gong) in the left speaker at maximum
  69. volume, namely 64.
  70.  
  71. At frame 15, it will play sound 0 in the right speaker at half the
  72. maximum volume, namely 32.
  73.  
  74. There is one background sound in this animation, which is a whistle, and
  75. it starts on frame 0, plays in the left channel, with a volume of 20.
  76.  
  77. Valid frame numbers are 0 to n-1, where n is the number of frames in
  78. your animation (in one complete cycle).  If the number is greater than
  79. n, the sound will not be played.  You may not always know how many
  80. frames an animation has, so it's a little hard to "retrofit" a sound
  81. to an animation, but not too hard.  The best approach is to make a
  82. guess at a frame number and try it, this will quickly tell you how
  83. close you are. 
  84.  
  85. Valid sound numbers are 0 to n-1, where n is the number of sounds in
  86. your animation.
  87.  
  88. Valid channels are L for left and R for right.
  89.  
  90. Valid volumes are 0 through 64.
  91.  
  92. Background sounds are sounds that start up the first time the desired
  93. frame appears, and then cycle on their own until the program ends.
  94.  
  95. If the audio specification file cannot be found, no sound will be played.
  96.  
  97.  
  98.  
  99. KNOWN BUGS:  
  100.  
  101. -- An apparent Manx overlay bug causes the floppy drive light and
  102.    motor to remain on during animation play. 
  103.  
  104. -- Amiga-N will cause unpleasant effects and a system lockup.  This is
  105.    because MOVIE makes assumtions about the viewport for speed's sake.
  106.  
  107. -- A system file requester has the same effect as Amiga-N.
  108.